触发器

每个 Zap 都只有一个触发器。触发器允许您的应用用户在应用中添加或更新项目时启动自动化工作流，例如新建或更新的联系人、数据库记录、博客文章、订阅者、表单条目或项目任务。

触发器仅监视新数据，通常不会向您的应用发送数据或仅发送少量数据。相比 Zapier 动作，设置触发器通常更快。

在设计触发器时，应以用户与您的应用互动的方式为核心，而不是依赖可用 API 端点。

触发器分为两种类型。

1. 轮询触发器

这种触发器类型会定期检查指定的 API 端点，以检测新数据或更新数据。

轮询的频率取决于用户的 Zapier 计划级别，每个活跃 Zap 每 1 到 15 分钟检查一次。

API 端点必须以数组形式列出新项目或更新项目，并按逆时间顺序排序。这些通常是最常见的读取平台数据的 API 端点。对于新建项目触发器，端点应优先列出新创建的项目；对于更新项目触发器，则应优先列出最近更新的项目。如果您的 API 默认以其他顺序列出项目，但支持排序，请在 API 调用中添加排序参数，以确保最新记录出现在 结果的第一页。

在触发器描述中，提供详细信息，让用户清楚哪些更新类型会激活触发器。

Zapier 会自动对轮询触发器的数据进行去重，从而避免 Zap 基于相同数据多次运行。这种去重机制已 向用户解释为一个概念。为符合用户预期，请遵循 去重指南，适用于新建项目和更新项目触发器。

2. REST Hook 触发器

这种触发器要求您的应用支持 REST Hooks——即通过 REST API 管理的 webhook 订阅。它以近实时方式运行，您的应用会主动将数据推送到 Zapier，从而在应用中出现新数据时立即执行 Zap，而非等待 Zapier 按轮询频率从 API 获取数据。

这种触发方式还能减少对您的 API 端点的大量（有时不必要的）轮询请求。

Zapier 和您的应用之间会建立 webhook 订阅，每当您的应用发生触发事件时，您的应用就会向 Zapier 为每个活跃 Zap 提供的专属 webhook URL 发送 webhook。

Zapier 支持立即 webhook 握手确认，通过回显 X-Hook-Secret 标头（如果存在）来实现，但不提供额外的身份验证步骤。